v10.0.2

Compare Source

• Fixed internal calculations for TextPath to return correct width and height

v10.0.1

Compare Source

• Fixed line-through render for center/right aligned text

v10.0.0

Compare Source

Breaking Changes

• Breaking: Konva module is fully migrated from CommonJS modules to ES modules. It may break some older bundlers and CommonJS environments. In CommonJS environment you have to use default property from require:

// before
const Konva = require('konva');

// after
const Konva = require('konva').default;

• Breaking: Dropped default support for node.js environment. Now you have to explicitly import it:

npm install canvas

import Konva from 'konva';
import 'konva/canvas-backend';

Motivation: With increased usage of konva in SSR environments like Next.js, loading native canvas rendering on the server is unnecessary since we don't render canvas content server-side. Removing this requirement simplifies setup by avoiding native modules when they aren't needed.

• Improved text positioning to match DOM/CSS rendering. To restore previous behaviour use Konva.legacyTextRendering = true. This should NOT break major part of the apps. But if you care about pixel-perfect position of text elements, that change may effect you.

New Features

• Added new skia render backend for node.js:

npm install skia-canvas

import Konva from 'konva';
import 'konva/skia-backend';

• Native filters support via node.filters(['blur(10px)']). Native fitlers works MUCH faster if supported nativily (Chrome, Firefox). If there is no native support, Konva will automatially fallback to functional filter (on Safari).

node.filters(['blur(10px')]);
node.cache();

• New property charRenderFunc for Konva.Text for controlling "per-character-render". May be useful any character animations:

var text = new Konva.Text({
  x: 10,
  y: 10,
  text: 'AB',
  fontSize: 20,
  charRenderFunc: function ({ context, index }) {
    if (index === 1) {
      // shift only the second character
      context.translate(0, 10);
    }
  },
});

• New: Added Konva.Filters.Brightness filter in replace of deprecated Konva.Filters.Brighten to better match with css filters logic.
• Added cornerRadius support for Konva.RegularPolygon
• Added miterLimit property support for Konva.Shape to control line join appearance

Bug Fixes

• Fixed corner radius render for Konva.Rect when negative width or height are used
• Fixed TextPath rendering on right align for some fonts
• Fixed crash when node inside transformer was destroyed
• Fixed mouseup + click events order when clicked on empty area of stage
• Fixed transformer drag behavior with non-draggable nodes

Technical Improvements

• Performance: Rewrote Emboss and Solarize filters for improved performance and usability
• Changed return type of node.toImage()
• Brave detection and warning